home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 001-025 / scopedisk2 / vt100 / readme < prev    next >
Text File  |  1995-03-18  |  16KB  |  315 lines
  1. This archive contains a vt100 emulator with KERMIT and XMODEM file
  2. transfer protocols.  Original work by Dave Wecker, V2.7-V2.8 by Tony Sumrall.
  3.  
  4. Thanks:
  5. -------
  6.     To everyone who sent in code, suggestions and fixes!
  7.  
  8. Releases:
  9. ---------
  10.     v2.8 880117 ACS - See Release Notes.
  11.     v2.7 870825 ACS - See Release Notes.
  12.     v2.6 870227 DBW - bug fixes for all the stuff in v2.5
  13.     v2.5 870214 DBW - more additions (see readme file)
  14.     v2.4 861214 DBW - lots of fixes/additions
  15.     v2.3 861101 DBW - minor bug fixes
  16.     v2.2 861012 DBW - more of the same
  17.      v2.1 860915 DBW - new features (see README)
  18.     v2.0 860823 DBW - Major rewrite
  19.     v1.1 860720 DBW    - Switches, 80 cols, colors, bug fixes
  20.     v1.0 860712 DBW    - First version released
  21.  
  22. Usage:
  23. ------
  24.     Please read VT100.DOC for usage information and examples.
  25.  
  26. Release Notes:
  27. --------------
  28. v2.8 880117 ACS - Info/Status window automatically deselected.
  29.     - 1st menu item re-worked.  Now the user need only choose Send,
  30.       Receive, Kermit Get, Kermit Bye and Capture.  Protocol to send or
  31.       receive is selected via the 1st sub-menu from the 1st menu item.
  32.     - New command: XPROTO XMODEM | XMODEMCRC | ASCII | KERMIT to select
  33.       transfer protocol via scripts.
  34.     - User may capture simultaneously with sending or receiving via
  35.       a different protocol by using the Capture menu item.  This item
  36.       changes to Capturing when capture is in effect.
  37.     - Kermit will transfer long packets (up to 1000 bytes).  New cmd:
  38.       "KMAXPACK n" sets maximum packet length to n bytes.  Remember to
  39.       increase your send and/or receive timeouts on your host!!!
  40.     - Added insert/delete character to the recognized escape sequences.
  41.       ESC [ n @ inserts n characters, ESC [ n P deletes n characters
  42.       (thanks to John Wang (jwang@ATRP.MEDIA.MIT.EDU)).  He suggests 
  43.       using the following termcap:
  44.       CA|vt100|amiga|Amiga termcap:al=\E[L:AL=\E[%dL:am:bl=^G:bs:cd=\E[J:\
  45.         :ce=\E[K:cl=\E[;H\E[2J:cm=\E[%i%d;%dH:co#80:cr=^M:cs=\E[%i%d;%dr:\
  46.         :dc=\E[P:DC=\E[%dP:dl=\E[M:DL=\E[%dM:do=^J:ho=\E[H:\
  47.         :is=\E[1;24r\E[24;1H:ic=\E[@:IC=\E[%d@:kb=^H:kd=\E[B:\
  48.         :ke=\E[?1l\E>:kl=\E[D:kr=\E[C:ks=\E[?1h\E=:ku=\E[A:k1=\EOP:\
  49.         :k2=\EOQ:k3=\EOR:k4=\EOS:le=^H:li#24:mb=\E[5m:md=\E[1m:me=\E[m:\
  50.         :mr=\E[7m:nd=\E[C:pt:rc=\E8:rf=/usr/lib/tabset/vt100:\
  51.         :rs=\E>\E[?3l\E[?4l\E[?5l\E[?7h\E[?8h:sc=\E7:se=\E[m:\
  52.         :sf=^J:so=\E[7m:sr=\EM:ta=^I:ue=\E[m:up=\E[A:us=\E[4m:vc#16:vt#3:xn:
  53.     - Fixed scroll regions.  Now will not wrap-around out of a scroll
  54.       region. (thanks to Tad Guy (ames!xanth.cs.odu.edu!tadguy))
  55.     - Fixed the FileLock() problem (thanks to many!).
  56.     - The "nagging requester" bug was a bug in *my* code (gasp!).  Thanks
  57.       to Joel Swank (joels@tekred.TEK.COM) for finding and squashing it!
  58.     - Fixed overzealous xmodem chopping.  It now strips contiguous
  59.       strings of nulls OR Ctrl-Z (not a mixture) and will avoid writing
  60.       anything if they were all chopped.  Thanks to Wayne Davison
  61.       (drivax!davison--I only had to modify it a little, Wayne).  Also,
  62.       when sending, it now sends a stream of nulls OR Ctrl-Zs, whichever
  63.       is NOT the last character.
  64.     - Removed an extraneous continue in readchar().  Thanks to someone!
  65.       (Sorry, I lost your name and address.)
  66.     - Now uses the default keymap.  All of the old mappings have been
  67.       retained (e.g. Ctrl-2 generates Ctrl-@, Ctrl-6 generates Ctrl-^,
  68.       ALT acts as META key (i.e. sets the high-order bit)).  Note,
  69.       however, that your keymap may preclude the use of the ALT key if
  70.       dead keys are defined.  A future version will support specification
  71.       of a keymap different from the system map.
  72.     - New commands: SENDF file-spec and REC file which will send/receive
  73.       via the default XPROTO setting.  You still have XS, KR, etc.
  74.     - New command: FONT font-name.  Allows the user to specify which
  75.       8-point font to use.  If you want to use your new whippy-font, sau
  76.       FONT whippy-font.  These must be 8-point fonts for now!
  77.     - Saying LINES 0 will use all available lines on the screen (useful
  78.       to you MoreRows groupies).
  79.     - P_unit may be changed in vt100.c to specify a different unit of
  80.       the serial.device to use (for expansion serial ports).  As of this
  81.       writing there are no expansion serial devices...this is just in
  82.       preparation for the future.  Also provided a new INIT command:
  83.       UNIT which accomplishes the same result.
  84. v2.7 870825 ACS - Requester is only used for input.  A new window (the
  85.       Info/Xfer Status window) now shows what used to go there and the
  86.       requester now comes up in this window.  The window is sizable,
  87.       draggable, closeable and front-to-backable; when re-opened it
  88.       will appear in its last location with its last dimensions.  The
  89.       window ignores input but will become active when it's first
  90.       displayed as well as when a requester is put up in it.  To
  91.       cancel a transfer request, first ensure that the mail VT100
  92.       windiw is active then hit ESC in it.
  93.     - KERMIT mode has been hardened and wildcarded files can be sent
  94.       to a KERMIT that is *not* in server mode.  E.g. you may say
  95.       RECEIVE to your host's KERMIT then send Foo* -- all files
  96.       starting with Foo in the current directory will be sent.
  97.     - New command line switches -i and +i.  -I says don't use an init
  98.       file, +i file says use "file".  User may also specify script
  99.       files on the command line which will be executed in sequence.
  100.     - New init file command SHORTCUT.  See vt100.doc.
  101.     - I've included the font code.  It looks for an env variable named
  102.       "font" (yes, lowercase) and, if found, uses that font for its
  103.       test.  If you don't like it you may wanna remove it.  I was gonna
  104.       ifdef it but I ran out of time.  Remember that there's a PD set
  105.       cmd to allow Lattice users to set env vars.
  106.     - Nagging bug: On 2nd and subsequent uses of the requester, the
  107.       1st character of the last use is redisplayed.  Intuition bug?
  108. v2.6 870227 DBW - bug fixes for all the stuff in v2.5
  109.     - Input requestors are now self selecting (ignore comment in 2.5)
  110.     - Added a BS<->DEL menu item and startup option (SWAP ON/OFF)
  111.     - Renamed dopen/dnext/dclose to diropen/dirnext/dirclose for LATTICE
  112.     - Added a CONVERT option that tells whether KERMIT should downcase
  113.     - MAJOR CHANGE: re write the INPUT/SCRIPT commands, see VT100.DOC
  114.     - Fixed a major problem with Set Directory causing LOCK conflicts
  115.     - Moved the Title up 1 pixel so that it doesn't get cut off anymore
  116. v2.5 870214 DBW - more additions (see readme file)
  117.     - All prompting now done through a string requester/gadget.
  118.       NOTE: YOU MUST SELECT THE INPUT STRING OF THE REQUESTER BEFORE
  119.         YOU CAN TYPE A RESPONSE.
  120.     - Local echo mode added (half duplex for Carolyn)
  121.     - BEEP command added to SCRIPT
  122.     - New menu/init/script items:
  123.         CLEAR SCREEN    - clears the screen
  124.          ECHO        - turns on/off half duplex mode
  125.         WRAP        - turns on/off autowrap on long lines
  126.         NUMKEY        - turns on/off numeric keypad mode
  127.         APPCUR        - turns on/off application cursor mode
  128.     - Rewrote toasc() to use qualifier field (no more getting the
  129.       keyboard "stuck")
  130.     - Fixed locking of directories (should now run under workbench ok)
  131.     - Cleaned up VT100.H to really check includes on compile
  132.     - Setting font explicitly to TOPAZ 8 (no more dumb assumptions)
  133.  
  134. v2.4 861214 DBW - lots of fixes/additions
  135.     - Beep should now work under Lattice
  136.     - CreatePort now passes longs (as it should always have)
  137.     - Nested comments in KERMIT.C removed
  138.     - Beep volume of 0 (DisplayBeep) now works
  139.     - snum[] declaration in KERMIT.C fixed
  140.     - multi_xfer is now void and return fixed (in kermit)
  141.     - "." can no longer get "stuck" as the break key
  142.  
  143.     - RIGHT-AMIGA-keys have been added for most menu items
  144.     - The ALT key is now an EIGHTth bit shifter
  145.     - Control-@, Control-2, Control-space send the NULL character
  146.     - Control-6 now sends Control-^
  147.     - Control-- and Control-? now sends Control-_
  148.     - Cursor application mode (<esc>[?1h and <esc>[?1l) now work
  149.     - XMODEM now masks the eighth bit if parity is other than NONE
  150.  
  151. v2.3 861101 DBW - minor bug fixes:
  152.     - added p_wbcolors to allow workbench colors on custom screen
  153.       (In the init file you can specify WBCOLORS to be NO (use color
  154.        definitions in INIT FILE or VT100.H) or YES (use WORKBENCH
  155.        colors for everything)).
  156.     - "$" now sends a kermit-bye (like it says in VT100.DOC).
  157.     - made window/screen heights more reasonable
  158.     - Added ANSI insert line and delete line (<csi><num>L and
  159.       <csi><num>M) to speed up various editors (like emacs).
  160.       NOTE: This is NOT a VT100 sequence (new extension).
  161.     - ctrl-space now also sends a null (along with ^@ and ^`)
  162.     - RAWKEY fixed in WINDOW.C
  163.     - p_wrap fixed in WINDOW.C
  164.     - removed WRDMAX from VT100.H
  165.     - fixed exit with no params in SCRIPT.C
  166.     - fixed parity comparisons in KERMIT.C
  167.     - init file [n+1] changed to [nplus1] to make Lattice happy.
  168.     - cursoron(), cursoroff() changed to one routine cursorflip().
  169.     - long lines shortened to less than 80 characters (for gateways).
  170.     - blanks following exit (or comments) now work in scripts.
  171.  
  172. v2.2 861012 DBW - more of the same:
  173.     - The INIT file "exit" can now chain to a script
  174.     - The SCRIPT command "exit" can now chain to another script
  175.     - Hangup menu item now works.
  176.     - Autowrap can now be set from VT100.H, VT100.INIT (<esc>[?7h l)
  177.     - Control-G is now handled with an audible beep
  178.     - Script now used "^chr" to send control characters
  179.     - The graphics "box" character (a) was added
  180.     - Control-@ and Control-` now send the NULL character
  181.     - Alternate color for BOLD has been re-instated by popular demand
  182.     - Menus have been cleaned up.
  183.     - Lattice compilation cleaned up.
  184.     - No more wordsize parameter since PARITY takes care of all cases
  185.     - Function keys can now call scripts
  186.     - Double shift keys are now handled correctly.
  187.     - Version has been added to the title bar (for bug reports).
  188.  
  189. v2.1 860915 DBW - new features / bug fixes
  190.     - Now identifies as a VT100 (including the response to <esc>Z)
  191.     - Cursor color now gets read in as hex (instead of decimal)
  192.     - REPORTMOUSE taken out of definitions (not needed)
  193.     - XON/XOFF now being handled by the device driver instead of me
  194.     - Literal escape characters have been replaced with \033
  195.     - At init time the user can now specify the input BUFFER size
  196.       (typically between 512 and 2048 bytes) depending on baud rate
  197.     - Script files are now case insensitive for commands
  198.     - XMODEM now turns off the driver XON/XOFF during transfers
  199.     - Graphic rendition now done by the OS instead of me.
  200.     - Initialization files are now searched for in S: instead of C:
  201.     - Forward GOTO bug fixed in the script package.
  202.     - Keypad can now be used in both numeric and application mode
  203.     - General purpose cleanup() routine added for all exits.
  204.     - Utility menu added (sendbreak, hangup, change directory).
  205.       NOTE: hangup is not implemented yet.
  206.     - Full wild card support in file transfers (see vt100.doc).
  207.     - Kermit cleaned up with better filename handling (from host).
  208.     - Script now has CD (changed directory) and SB (send break) commands
  209.     - Added Parity and Wordsize choices in VT100.H, VT100.INIT, menu
  210.       and scripts. (Generates parity from a table).
  211.     - Added 8th bit quoting in KERMIT when using 7 bit words (ODD or
  212.       EVEN parity).
  213.     - Break time can be set from VT100.H, VT100.INIT or a script file.
  214.     - Transfer mode (image or CRLF) can now be set from a script file.
  215.     - Control characters in escape sequences now act like a true VT100.
  216.     - F10 now works from init files.
  217.     - Right (or Left) AMIGA with period (".") sends a BREAK to the host
  218.       from the keyboard.
  219.     - XMODEM status kept down to one line for a file transfer.
  220.  
  221. v2.0 860823 DBW    - Major rewrite:
  222.     - Emulator now compiles under either MANX or LATTICE by defining
  223.       the appropriate compiler type in VT100.H.
  224.     - Sped up code to an effective baud rate of (about) 8k. This means
  225.       that clear text at 4800 baud should be no problem.
  226.     - Added XON/XOFF generation so that characters should not get lost
  227.       any more at 9600 baud (when receiving clear text).
  228.     - Got rid of all command line switches and environment variables.
  229.       Instead upon invocation the program searches first for any file
  230.       named on the command line, then looks for VT100.INIT in the
  231.       current directory and finally searches for C:VT100.INIT.
  232.       All parameters can be set in the init file, and a sample VT100.INIT
  233.       is provided in VT100.DOC that shows all possible options.
  234.     - All parameters that are set by VT100.INIT are defined in VT100.H
  235.       (variables starting with "p_"). This allows you to compile your
  236.       own defaults into the code.
  237.     - You can now set the number of lines (for all you EMACS freaks :-).
  238.       On an interlaced screen this gives you upto a 48 line terminal.
  239.     - WORKBENCH colors are NEVER touched.
  240.     - In an attempt to keep the size down, the color palette menu item
  241.       has been removed (current). Code is about 36K in size with a
  242.       run time image (using workbench screen) of about 88k.
  243.     - Many bugs fixed including reverse scrolling with descenders,
  244.       reverse video at end of line, clearing with scrolling regions,
  245.         ... and 20 or more others.
  246.     - File capture now no longer sends the filename to the host.
  247.     - BOLD (<esc>[1m) has now been added by using an additional color
  248.       when you specify a depth of 2 (instead of 1) bitplane.
  249.     - UNDERLINE (<esc>[4m) has now been added.
  250.     - The handling of remote (host) escape sequences has been completly
  251.       re-written (thanks to Dawn Banks for all the work).
  252.     - Function keys (and shifted function keys) can now be bound to
  253.       arbitrary strings (Jim Ravan gets his macros). See VT100.DOC
  254.       for details.
  255.     - Cursor has no been reduced to the size of a normal character for
  256.       easier readability.
  257.     - XMODEM has been improved (by Steve Drew) to use a timer device
  258.       (for timeouts) and to abort immediately if the user types <ESC>.
  259.     - KERMIT has been completely re-written and appears to work fine,
  260.       thanks to the efforts of Steve Drew.
  261.     - New menu item allows script file support. Module written by
  262.       Steve Drew. See VT100.DOC for details.
  263.  
  264. Known problems:
  265. ---------------
  266.     none
  267.  
  268. Suggestions/bug fixes not implemented (as of yet):
  269. --------------------------------------------------
  270.     - Custom screen should use a borderless backdrop window
  271.     - Quit from keyboard should be supported (for above)
  272.     - Automatic maximum sizing of window should happen
  273.     - Screen should be resizable
  274.     - AT TIME should be implemented in scripts (besides DELAY)
  275.     - Kermit should create sub directories (when necessary)
  276.     - Use a disk font for graphic character set
  277.     - Allow the mouse to be sent to the host (for various EMACSs)
  278.     - Kermit VM/CMS (IBM) protocol support (it works for me, how about
  279.       you?)
  280.     - Allow the user to use a keymap different from the default one.
  281.     - Allow use of an "external" transfer protocol.
  282.     - Allow use of other than 8-point fonts.
  283.  
  284. Installation:
  285. -------------
  286.     The files in this archive may be extracted by the bourne shell
  287.     (/bin/sh) or the shar program using the "unshar switch (-u)",
  288.     contact me if you need a copy of this version of shar.
  289.  
  290.     REMEMBER: Set the correct compiler definition in VT100.H
  291.  
  292. Files:
  293. ------
  294.     README        - this file
  295.     vt100.doc    - documentation for the terminal emulator
  296.     makefile    - make file for the emulator (under MANX AZTEC-C)
  297.     vt100.h        - include file used by all other modules
  298.     window.c    - manager for window and keyboard
  299.     vt100.c        - main module, handles menus
  300.     remote.c    - handle remote characters (vt100 emulation)
  301.     kermit.c    - kermit protocol (to transfer text files on VMS
  302.               select the CRLF option on the transfer mode menu,
  303.               otherwise use image mode).
  304.     init.c        - startup code
  305.     xmodem.c    - xmodem protocol that understands AMIGA binary and
  306.               text file formats (automatically).
  307.     script.c    - script control package
  308.     expand.c    - filename expansion (wildcards) and dir setting
  309.  
  310. Contact:
  311. --------
  312. Please send bugs/comments/suggestions/praise for V2.8 to:
  313.  
  314.     Tony Sumrall at USENET: acs@amdahl.com
  315.